home *** CD-ROM | disk | FTP | other *** search
/ Windows 6-Pak - Disc 6 / Windows 6-Pak (InfoMagic) (Disc 6) (1999).ISO / Explorer-Addons / vgsfinst.exe / VGSelectFile.CAB / README.TXT < prev    next >
Text File  |  1998-12-29  |  9KB  |  188 lines
  1. README.TXT for VGSelFil.DLL and VGSelectFile.EXE
  2.  
  3. DESCRIPTION OF VGSelFil.DLL:
  4.    VGSelFil.DLL is an In-Process OLE Server DLL written in VB6
  5.    It provides objects of the class VGSelectFileDLL.SelectFile
  6.    This object may be instantiated by the programmer from other programs
  7.       to provide an advanced and flexible file or directory browser capability.
  8.    Using the form opened, the user can select either a file or directory
  9.       as specified by the calling program
  10.    The features and options presented to the user may be configured 
  11.       by the calling program (or by the user if allowed by the calling program),
  12.       including whether to show or hide hidden directories, 
  13.       or to display files having any specified combination
  14.       of read-only, system, hidden, or archive attributes.  
  15.       Also a range of allowable dates may be specified that limits 
  16.       the files displayed.
  17.       In addition, the files displayed may be limited to 
  18.       those matching a pattern using "*" or "?" wild characters.
  19.    Before the form displayed is closed, the user may optionally
  20.       copy the fully qualified file specification of the file selected
  21.       to the clipboard for use elsewhere.  This file specification 
  22.       is displayed in Long File Format (including all parent subdirectories)
  23.       as well as short (DOS 8.3) file and directory format.  The latter
  24.       can be useful in passing the file specification to a program 
  25.       which does not recognize long file or directory names.
  26.   
  27.  
  28. FULL LISTING OF PROPERTIES AND METHODS:
  29.     The calling App can set these properties before displaying the main form
  30.        FormCaption (Text to appear at the top of the form) v. 3.0
  31.        FilePattern (pattern to restrict file search to, e.g. "*.txt") v. 1.3
  32.        AttributesToAvoid (Combination of one or more attributes such as vbSystem, vbHidden etc., 
  33.           file search will be restricted to not show these attributes) v. 1.3
  34.        AttributesToRequire (Combination of one or more attributes such as vbSystem, vbHidden etc., 
  35.           file search will be restricted to show only files containing all of these attributes) v. 1.3
  36.  
  37.        EarliestDate (e.g., "9/1/1998") v. 1.3
  38.        LatestDate  (e.g., "9/1/1999") v. 1.3
  39.        IncludeAllDates (True / False) v. 1.3
  40.        IncludeHiddenDirectories (True / False) v. 1.3
  41.        StartingPath (e.g., "C:\Windows\System32") v. 1.3
  42.        UserMaySpecifyCriteria (True / False) v. 1.3
  43.    
  44.     The calling App can call these methods before the form has been displayed
  45.        PrepareToFetchDirectory v. 1.3
  46.        DisplayForm (to show the form) v. 1.3
  47.    
  48.     The calling App can get these properties after the user "closes" the form
  49.       [Note that the form is still open but has been hidden]
  50.        DirectorySelected (text string) [if PrepareToFetchDirectory was chosen] v. 1.3
  51.        FileSelected (text string) v. 1.3
  52.    
  53.     The calling App can call this method after the user "closes" the form
  54.        UnloadForm (to unload the form after reading its return value) v. 1.3
  55.   
  56.     The user can display the current version number of the DLL by
  57.        double-clicking on the main form
  58.  
  59. VGSelFil.DLL runs under and has been tested only with Windows NT 4.0
  60. VGSelFil.DLL is copyrighted by Michael McGoodwin.
  61. The user is welcome to use VGSelFil.DLL without cost but may not charge
  62.    to redistribute it.
  63.  
  64.  
  65.  
  66. DESCRIPTION OF VGSelectFile.EXE
  67.    VGSelectFile.EXE is a freestanding application program
  68.       which uses VGSelFil.DLL and thus demonstrates its capabilities.
  69.       The user may run this program to search for a file or to display 
  70.       its fully qualified file specification (i.e., drive and all 
  71.       subdirectories as well as file name) in long or short (DOS 8.3) 
  72.       file name format (formatting applies to subdirectories in the path as well.)
  73.       In particular, it is useful for passing a file to from
  74.       File Manager or from Explorer in order to copy its fully qualified 
  75.       file specification to the clipboard, either in Long or Short format.
  76.  
  77. VGSelectFile.EXE runs under and has been tested only with Windows NT 4.0
  78. VGSelectFile.EXE is copyrighted by Michael McGoodwin.
  79. The user is welcome to use VGSelectFile.EXE without cost but may not charge
  80.    to redistribute it.
  81.  
  82. To run VGSelectFile.EXE in File Manager:
  83.    (1) Using the File | Run command
  84.        Be sure VgSelectFile.EXE is in the executable path, i.e., 
  85.           The destination directory of VGSelectFile.EXE must be pointed to by the Path variable.
  86.           (Add if necessary with Control Panel | Settings | System | Environment | Path = ...
  87.        Highlight a file
  88.        Invoke File | Run and type VgSelectFile in front of the file name showing, press <Enter>
  89.    (2) Using a File Manager "shortcut"
  90.        Create a command script file VgSelectFile.CMD with these contents:
  91.            start <Your install location>\VGSelectFile.EXE %1%
  92.        Create a permanent New window that opens when starting file manager
  93.        Point this window to the directory holding VgSelectFile.CMD (perhaps, "C:\CMD")
  94.        Save the file manager window configuration with Alt-Shift-F4 so that this window will
  95.           show when file manager is opened
  96.        Drag a desired file to this command script file and drop it on it 
  97. To run VGSelectFile.EXE in Windows Explorer:
  98.    First time only: If you have not already done this, create a shortcut file (.LNK)
  99.       in Windows Explorer or the Desktop pointing to the VGSelectFile.EXE file.
  100.       Name it "VGSelectFile"
  101.       Copy this shortcut file (i.e., "VGSelectFile.LNK") to the SENDTO directory
  102.          for the current user (i.e., you), e.g.
  103.          C:\WINNT\Profiles\Administrator\SENDTO\VGSelectFile.LNK
  104.    Highlight the desired file in Windows Explorer
  105.    Right-Click to invoke "Send To" and select VGSelectFile
  106.  
  107.  
  108. INSTALLATION:
  109.  
  110. Close all running programs
  111. Place vgsfinst.exe in an empty temporary directory, run it, 
  112.    specify an empty temporary destination (may be the same one) 
  113.    as the destination directory to hold the installation files
  114.    and press Unzip to decompress the files needed to install VGMirror.  
  115. Find and run Setup.exe (one of the files that have been decompressed)
  116.    Select a final directory of your choice to install VGSelectFile.EXE to.
  117.    Note that the DLL VGSelFil.DLL will be installed 
  118.       in the Windows System directory automatically.
  119. After installation, you may delete all files in the temporary directory
  120.    where the decompressed files including setup.exe were placed.
  121. You may wish to have VgSelectFile.EXE is in the executable path, i.e., 
  122.     The destination directory of VgSelectFile.EXE must be pointed to by the Path variable.
  123.     (Add if necessary with Control Panel | Settings | System | Environment | Path = ...
  124.  
  125.  
  126. NOTE: If you encounter difficulties updating system files needed by the install program,
  127.    Do the following:
  128.       (1) Be sure your system Temp directory is on the same drive as
  129.           the Windows NT operating system. If you have to change
  130.           the location of the temp directory, reboot before proceeding.
  131.           Note: Change setting with Settings|Control Panel|System|Environment|Temp
  132.       (2) Run setup.exe and allow the system to reboot when this is suggested
  133.       (3) Run setup.exe again, should be able to proceed normally
  134.       (4) If appropriate, restore the original system temp directory setting
  135.    This problem has been traced to an NT4 limitation on moving
  136.        system files between drives on a delayed basis.
  137.  
  138.  
  139. FILES REQUIRED:
  140.    (List does not include MS VB or setup files)
  141.    README.TXT           This file
  142.    VGSelectFile.exe     See above
  143.    VGSelFil.dll         See above
  144.  
  145.  
  146. PROGRAMS KNOWN TO BE USING VGSelFil.DLL (Partial Listing):
  147.    (These notes are of benefit primarily to the developer)
  148.     VGClean.exe
  149.     VGSelectFile.exe
  150.  
  151.  
  152. REVISIONS HISTORY for VGSelFil.DLL:
  153.   (These notes are of probably of interest only to the developer)
  154.  
  155. 2/12/98 v. 1.1
  156.    Original DLL written in VB5
  157. 9/29/98 v. 1.2
  158.    Recompiled in VB6
  159.    Added revised validation for dates in frmAttributes
  160.    Added short file/directory file specification display to frmVGSelectFile
  161. 9/30/98 v. 1.3
  162.    Fixed OLE Drag/Drop for the text boxes
  163.    Display DLL version with double-click on main Form
  164.    Must create Dependency file w PD Wizard before creating VGSelectFile.exe package
  165. 12/15/98 v. 1.4
  166.    Revised DLL Base Address to avoid rebasing
  167. 12/29/98 v. 1.5
  168.    Added Ctrl-C Method of copying selected text to clipboard for LFN and SFN text boxes
  169.  
  170.  
  171. REVISIONS HISTORY for VgSelectFile.exe:
  172.   (These notes are of probably of interest only to the developer)
  173.  
  174. Earlier revision history N.A.
  175. 8/6/97 v. 3.0
  176.    Compiled in VB5
  177. 9/30/98 v. 4.0
  178.    Now calls VgSelFil.DLL, not independent
  179.    Added revised validation for dates in frmAttributes
  180.    Added short 8.3 file/directory specification textbox to frmVGSelectFile
  181.    Compiled in VB6
  182.    Added dummy form so that icon and Appname appear in Task Bar button and Task Switcher
  183. 12/29/98 v. 4.01
  184.    No change
  185.  
  186.  
  187.  
  188.